MailMessage コンストラクタ(String,String,FileInfo[])

新しいTextpart、Htmlpart、リンクされたResourceパートを使用して、Partsを初期化します。

シンタックス

Visual Basic (宣言)
C#

Public Function New( _
   ByVal text As String, _
   ByVal html As String, _
   ByVal htmlResources() As FileInfo _
)

public MailMessage( 
   string text,
   string html,
   FileInfo[] htmlResources
)

パラメータ

text: Multipart.Text（Parts[0]）の初期化に使用されます。nullまたは空の場合、Textpartは作成されません。
html: Multipart.Html（Parts[1]）の初期化に使用されます。nullまたは空の場合は、ArgumentNullExceptionがスローされます。
htmlResources: Multipart.Htmlによって参照されるリンクされた埋め込みリソースを提供する"multipart/related"パート（Parts[1]）の初期化に使用されます。

例外

例外	解説
System.ArgumentException	htmlResourcesの中に、ある特定のHTMLリンクへの参照が見つかりません。
System.ArgumentNullException	htmlをnullまたは空にすることはできません。

解説

このコンストラクタは、HTMLメールの作成に使用されます。提供されたパラメーターを表すため、"multipart/alternative"パートおよび"multipart/related"パートの一方または両方が作成されます。

textがnullまたは空の場合は、htmlとhtmlResourcesを使用して、"text/html"パート、または"text/html"パートを含む"mulipart/related"パートが作成されます。それ以外の場合は、Part.ContentTypeが"multipart/alternative"に設定され、2つのパートが作成されてPartsに保存されます。

htmlResourcesがnullの場合、htmlは単一のHtmlpartとして表されます。それ以外の場合は、新しい"multipart/related" Multipartが作成され、htmlとリンクされたhtmlResourcesで初期化されます。

使用例

以下のサンプルコードは、新しいMailMessageを作成し、ローカルファイルを参照するHTML（Internet Explorerで［Webページ、完全 (*.htm;*.html)］として保存したHTMLファイルなど）をそのMailMessageに設定する方法を示します。

private MailMessage getMessageFromHtml(string pathToHtml, string fromAddress, string toAddress, string subject)
 {
     // メモ: .mht（MIME HTML）ファイルをロードする場合は、代わりにMailMessage.Open()を使用します。

     // HTMLをロードします。
     StreamReader sr = new StreamReader(pathToHtml);
     string html = sr.ReadToEnd();
     sr.Close();

     // MailMessageオブジェクトを初期化します。includeTextPlainは、メッセージにtext/plainパートを含めるかどうかを制御します 
     // （メッセージがmultipart/alternative（trueの場合）とmultipart/related（falseの場合）のどちらになるかを決定します）。
     string textPlain = (includeTextPlain) ? "text/plain representation of included HTML" : null;
     MailMessage mailMsg = new MailMessage(textPlain, html, new DirectoryInfo(pathToHtmlResources).GetFiles());

     // 送信者、受信者、件名を設定します。
     mailMsg.From = fromAddress;
     mailMsg.To = toAddress;
     mailMsg.Subject = subject;
     return mailMsg;
 }

Visual Basic

Private Function getMessageFromHtml(ByVal pathToHtml As String, ByVal fromAddress As String, ByVal toAddress As String, ByVal subject As String) As MailMessage
     'メモ: .mht（MIME HTML）ファイルをロードする場合は、代わりにMailMessage.Open()を使用します。

     ' HTMLをロードします。
     Dim sr As New StreamReader(pathToHtml)
     Dim html As String = sr.ReadToEnd()
     sr.Close()

     ' MailMessageオブジェクトを初期化します。includeTextPlainは、メッセージにtext/plainパートを含めるかどうかを制御します 
     ' （メッセージがmultipart/alternative（trueの場合）とmultipart/related（falseの場合）のどちらになるかを決定します）。
     Dim textPlain As String = If(includeTextPlain, "text/plain representation of included HTML", Nothing)
     Dim mailMsg As New MailMessage(textPlain, html, New DirectoryInfo(pathToHtmlResources).GetFiles())

     ' 送信者、受信者、件名を設定します。
     mailMsg.From = fromAddress
     mailMsg.To = toAddress
     mailMsg.Subject = subject
     Return mailMsg
End Function

参照

MailMessage クラス
 MailMessage メンバ
 オーバーロード一覧